Disk Jacket v1.7 ======================= By Kenneth W. Hartlen April 1,1992 Disk Jacket v1.7 scans a disk drive and saves the first 129 file names, sorts them by directory and filename, and prints a 3 1/2" or 5 1/4" jacket with the directory and file names listed on it. A jacket name, current date and available disk space are also printed on the jacket. If you regularly give your disks volume names, Disk Jacket v1.7 can use the disk volume name for the jacket name. My original purpose for writing this program was to have a file list for disks that contained source code and documents for my university courses. By simply flipping through my disks I knew what was on them without needing to use my computer. Now I usually print a jacket for master disks, for ST FORMAT, Atari ST User and STart magazine disks, etc. Now I can easily locate the files and programs I need. Friends expressed an interest in this utility, so I thought I'd share it with others. I wrote the program in C and the ST version was compiled using Lattice C v5.06 and the PC version was compiled using Turbo C v2.0. JACKET17.ARC ============== The archive file JACKET17.ARC contains the required files for using Disk Jacket v1.7 on an Atari ST or an PC compatible computer. JACKET.TTP The ST version of the Disk Jacket v1.7 program. Run from GEM, NeoDesk or a CLI. JACKET.EXE The PC version of the Disk Jacket v1.7 program, run from MS-DOS. JACKET.CFG The printer configuration file. LQ2500.CFG Configuration file for Epson LQ2500 printer. JACKET17.TXT This file. JACKET.NIC NeoDesk v3.02 icon file containing an icon for the ST version of the Disk Jacket v1.7 program. If any of these files are missing, the original JACKET17.ARC file has be tampered with. Please locate a complete JACKET17.ARC file. Using Disk Jacket v1.7 ======================== To run the program on an ST, simply double-click the JACKET.TTP icon in GEM or NeoDesk. Since the program is a .TTP, you will be prompted for parameters. When run from a CLI on a ST or from MS-DOS on a PC, you must specify the parameters. The program usage is: jacket [-ab35ldsvu] [name] Here is a list of legal options: -a process drive A (*) -b process drive B -3 create 3.5" disk jacket (*) -5 create 5.25" disk jacket -l use letter quality font -d use draft quality font (*) -s suppress progress messages -v use NeoDesk, TOS or MS-DOS volume name (*) -u use user's jacket name [name] user specified jacket name Note: (*) indicates the default options used when parameters are not specified. If the -v option is used, Disk Jacket v1.7 searches for the NEODESK.DAT file, if not found the disk TOS/DOS volume name will be searched for, and if neither was found a the jacket name will not have a name. If you want to use your own jacket name, use the -u option and make sure the jacket name is the last parameter and enclose the name in double quotes if it contains spaces. Disk Jacket v1.7 will return one of two exit codes: 0: the program terminated normally. -1: an illegal parameter is encountered. Or the printer is not ready. Or the disk being scaned is empty, no directories or files. (Note: The PC version looks for a printer on the LPT1 port). Note: ST users creating jackets for disks originally formatted on an PC compatible may notice that the volume name may appear on the jacket. This occurs if the MS-DOS program LABEL.COM was used to give the disk a label name. It creates a volume name but doesn't hide it. The files are listed in three columns on the jacket. Directory names will separate the files as they exist on the disk and are preceded by a backslash (\). The file names are listed top to bottom since it is easier to see the directory structures these way. The program searches subdirectories and ST users should keep the 40-folder limit bug in mind and ensure a patch has been loaded before running Disk Jacket v1.7. After the jacket is printed it must be finished by you. Simply cut out and fold the jacket as instructed, then tape it together (I prefer using a UHU Stic glue stick). The jacket is now ready to accept your disk. Since most of the time 3 1/2" jackets will be printed, you can save paper by cutting, or folding, single sheets into 5 1/2" by 8 1/2" sheets and single feeding them lengthways into the printer. I have a Panasonic KX- P1124 with front paper feed so this is convenient. Now finding that file in a box of disks should be a little easier and you won't have to power up your computer to do it. The Configuration File ========================= Since each model of printer will have different setup codes, the Disk Jacket v1.7 program reads a configuration file called JACKET.CFG which must contain the control codes for your printer. If JACKET.CFG can not be found, Epson LQ2500 defaults will be used. I've supplied a configuration file for the Epson LQ2500 and you can easily create your own, if necessary. The JACKET.CFG file must have the following format and can be modified using any text editor. All values must be separated by at least one space and be the decimal for the printer code. Line 1: Disk Jacket Printer Configuration Codes, Epson LQ2500 Line 2: 003 027 103 015 /* 15cpi, Micron mode */ Line 3: 003 027 065 007 /* 7 60th spacing */ Line 4: 003 027 120 001 /* letter quality font */ Line 5: 001 012 /* printer form feed */ Line 6: 002 027 064 /* printer reset */ Line 1: Simply holds a comment for your purposes and is ignored by the Disk Jacket v1.7 program. Line 2-6: These lines contain the printer codes that your printer recognizes. The first number is the number of values that follow. Then up to ten control values, separated by spaces, will be read. Again a comment for your purposes at the end of the line is ignored. If Disk Jacket v1.7 is not changing the cpi or lpi settings on your printer, check to make sure your printer is set so it will accept software control codes. If the 3 1/2" jacket is too small or too large, make sure the the cpi is being set to 15cpi. Disclaimer and Notes ====================== Disk Jacket v1.7 is freeware, meaning JACKET17.ARC can be distributed freely (unmodified) and there is no cost to own a copy. Disk Jacket v1.7 is provided AS IS. I make no warranties, either expressed or implied, with respect to the software, its quality, performance, or fitness. I will not be liable for direct, indirect, or consequential damages resulting from any defects in the software. Having said that, I hope you find Disk Jacket v1.7 as useful as I do. Suggestions to improve Disk Jacket v1.7, or if any bugs are encountered, or if you'd like to send $ (yeah, right!) can be reported to myself: Kenneth W. Hartlen Box 37, Site 6, RR#3 Armdale, Nova Scotia Canada B3L-4J3 Please send a self-addressed stamped envelop if you would like me to reply. I can also be reached by e-mail (until the university realizes I've graduated) at my Internet addresses: hartlenk@newton.ccs.tuns.ca or hartlenkw@watt.ccs.tuns.ca